home *** CD-ROM | disk | FTP | other *** search
/ TPUG - Toronto PET Users Group / TPUG Users Group CD / TPUG Users Group CD.iso / CRS / crs58.d81 / geogif.sfx / geogif.doc (.txt) < prev   
GEOS ConVerT  |  1990-02-12  |  5KB  |  44 lines

  1. geoGIF.doc
  2. SEQ formatted GEOS file V1.0
  3. Okimate 20
  4. 128 COMM 1351(a)
  5. dr.rel
  6. geoGIF_Main.rel
  7. geoGIF_Decod.rel
  8. geoGIF_Graph.rel8
  9. geoGIF_Stage.rel
  10. Write Image V1.1
  11. Red Storm
  12. geoWrite    V1.1
  13.   This file was created with
  14. Wrong is Write.
  15.   Written by Joe Buckley.
  16.      HgeoGIF
  17. Copyright 1990, Randy Weems
  18.      @GIF and 'Graphics Interchange Format' are trademarks (tm)
  19. of Compuserve Incorporated, and H&R Block Company.
  20. geoGIF is the copyright property of Randy Weems.  geoGIF is released as shareware;  if you find this software useful, please send a $10 shareware fee to...
  21.     Randy Weems
  22.     2200 Centerpoint Rd
  23.     Cumberland Furnace, TN 37051
  24.      @Introduction
  25. geoGIF is a GIF data stream to geoPaint file convertor.  It uses an advanced dithering technique to produce excellent quality monochrome results.  geoPaint or a geoPaint file viewer may be used to view the results.
  26.      @Use
  27. Operation of geoGIF is simple.  Upon opening geoGIF from the desk top, the user will immediately be presented with a files dialog box.  This dialog box will list the first 160 non-GEOS files ending in '.GIF' (case is not important).  The standard DRIVE and DISK icons are provided.  A file may be selected by clicking on it, by clicking on the icons at the bottom of the dialog box (if more than seven files are present), or by using the UP/DOWN cursor key.  A selected file may be opened by clicking on the OPEN icon, by double clicking on the file, or by hitting the RETURN key.
  28. When a file is opened, geoGIF will first verify that it is a GIF data stream.  If it is a valid GIF data stream, geoGIF will prompt the user for the output geoPaint file name.  This defaults to the original GIF file name minus the '.GIF' suffix.
  29. Next, the user will be provided with some information about the GIF data stream in a 'Screen Descriptor' information box and decoding will begin.  Information and progress for each image in the data stream is provided on screen in.  When the conversion is complete, the user will be returned to the files dialog box.
  30. When you have converted all the GIFs you want, select CANCEL from the files dialog box to return the the deskTop.  You may then use geoPaint or a geoPaint file viewer to view or print the files.
  31.      @Dithering Technique
  32. geoGIF uses a dithering technique known as error distributed dithering (specifically, it is a Stucki dither).  This is generally considered to be the dithering technique that produces the best results.  One disadvantage is speed; the dithering slows geoGIF down more than anything else.  Considering the results though, geoGIF runs at a fairly respectable speed.  Another disadvantage is the amount memory required; GEOS doesn't give applications much room to begin with.  After you subtract off the memory needed for decoding the GIF and the memory needed for dithering, very little room is left for the code itself.  The biggest disadvantage is that error distributed dithering requires that the raster lines of the images must be in sequential format; the only way to support interlaced images when using error distributed dithering is to buffer half the image.  Due to memory constraints, this certainly isn't feasible.
  33.      @Multi-image GIFs
  34. There is no reason why a GIF d
  35.      @Multi-image GIFs
  36. There is no reason why a GIF data stream must contain only one image (although most do).  GIF was designed to allow multiple images per data stream.  Unlike most decoders for 8-bit Commodore computers, geoGIF correctly supports multi-image GIFs (MIGs).
  37.      @Interlaced images
  38. Version 1.0 of geoGIF does not support interlaced images.  This is due to the dithering technique used.  A later version of geoGIF may support interlaced images, or I may provide a utility to convert interlaced images to sequential images in the near future.  This is the 
  39.      @ONLY
  40.  feature of the GIF87a specification not supported.
  41.      @Comments
  42. Please send your comments and suggestions.  During the summer, I can usually be reached on CompuServe (72437,2702) and QLink (RandyW18).
  43. -Randy Weems
  44.